Skip to main content

表单应用的 Zapier 集成结构

基于 Zapier 构建的表单和调查应用集成允许用户将移动数据收集表单连接到其他应用，从而将响应作为新联系人、文档模板、消息等发送。

要在 Zapier 平台 UI 中添加表单或调查应用集成：

先决条件​

1. 添加新的条目或响应触发器​

  • 在 https://developer.zapier.com/ 上为您的应用启动一个新集成。
  • 创建一个 新表单条目/提交 或 新调查响应 触发器。
  • 使用标准的 New 命名模式，让用户了解此触发器仅检索新条目，而非现有条目。

Platform UI vs CLI comparison

2. 配置特定表单的选择​

  • 添加一个 动态下拉菜单，以精确检索表单名称，就像它们在您的应用中显示的一样。
  • 如果下拉菜单使用的端点支持排序，您可以使用 sort_by 参数按创建日期排序，将列表按最近添加的表单顺序排列，从而便于用户选择所需的表单。
  • 将表单选择设为必填项，以便触发器仅监视此特定表单的响应。
  • 如果将表单字段设为可选，它可用于任何表单的响应；请添加帮助文本，让用户了解如果不选择表单会如何处理。

3. 格式化触发器接收的响应​

问题和答案字段​

  • 表单字段或调查问题在 Zapier 中的名称必须与您的应用用户界面中显示的字段名称相同。

  • 在一个询问联系信息的表单中，问题/字段“您的电子邮件是什么？”在您的应用 API 中可能使用像 1839dod38k01 这样的 ID 或通用标签如 Question 1。用户在 Zapier 中应看到友好的字段名称，以便轻松识别哪个字段用于映射数据到后续步骤。原始字段 ID（即 key）可以显示在友好的名称旁边。

  • 例如，一个常见用例是将响应记录到电子表格中，每个答案字段映射到不同的列。只显示键值如 q_1_answer 会让用户难以理解。请包含带有完整问题的标签。

  • 如果可能，在标签前添加问题编号作为前缀，以帮助用户快速定位特定问题和字段。

Platform UI vs CLI comparison

多项选择字段​

  • 如果可能，将问题标题、答案和值作为单独的字段返回，并使用相同的标签将它们分组在触发器输出中。

  • 当多项选择问题基于一系列值（例如，从“不太同意”到“非常同意”），返回选择值（如 1 到 5）以及实际答案会很有用。这对于希望在电子表格中跟踪响应的用户特别有益。

Platform UI vs CLI comparison

多选字段​

  • 当用户可以在表单或调查中选择多个响应（例如，复选框列表）时，在触发器中使用这些数据可能会很复杂。

Platform UI vs CLI comparison

  • 如果可能，将这些响应单独返回：将每个问题响应拆分成自己的字段，如果响应者选择了它，则带有值；如果未选择，则为空值。这可以简化 Zap 步骤的映射，用户可以将所有响应映射到一个字段，使用正确的分隔符分开，或者使用过滤器或路径针对特定响应采取行动。

Platform UI vs CLI comparison

  • 根据您的应用 API 响应字段，您可能选择将问题的选定值返回为一个逗号分隔的单一字段。用户随后可以使用 Zapier 的 Formatter 工具自行拆分这些值，或者将所有值一起映射到后续步骤的字段。

Platform UI vs CLI comparison

日期字段​

  • 以 ISO 8601 格式返回响应完成的 时间戳。同时，以 ISO 8601 格式返回表单或调查中用户可以选择的任何日期。

  • 如果可能，还应包括响应完成日期以及其他选定日期的人类友好格式。

Platform UI vs CLI comparison

文件附件​

  • 当用户可以将文件附加到表单响应时，请在响应数据中包含这些文件作为公开可访问的 URL。

  • 您可以配置 Zapier 通过文件去水化请求完整文件，但需要使用平台 CLI 来处理。

4. 在 API 配置下选择触发器类型​

REST Hook 触发器​

  • 当您的用户在短时间内有许多表单条目时，使用 webhooks 会让您的集成更可靠，从而防止大量新条目超过轮询结果的页面大小。

  • 使用 REST hooks，Zapier 无需反复轮询您的 API 来检查新响应。

轮询触发器​

  • 使用轮询触发器时，对于 REST Hook 触发器的 Perform List URL，轮询 URL 应返回所选表单的最新表单条目。

  • 如果所选表单没有条目，请返回一个空数组。Zapier 会提示用户创建样本，然后在 Zap 编辑器中重新测试他们的触发器，以完成 Zap 的映射。

5. 处理样本数据​

  • Zapier 在用户选择 Skip test 时，会为每个触发器和操作请求样本结果，如果测试 API 调用返回无数据。

  • 由于表单应用具有每个用户独有的动态字段，因此不可能定义适用于每种表单的样本数据。

  • 相反，只需为触发器的静态样本数据包含所有结果中都会出现的常见表单字段，例如表单 ID 和 时间戳。

6. 测试您的触发器​

为以下标准创建使用该触发器的 Zaps，以确保您的应用集成按预期工作：

  • 一个已经包含完成条目的触发表单，您应该检查轮询 URL 是否首先返回最新的表单条目（逆时间顺序）。
  • 一个全新的触发表单，没有条目，以确保您的表单在没有结果时返回适当的错误。
  • 一个包含必填和可选问题的触发表单，以确保所有问题都可以映射到后续操作步骤中，无论最新的响应只回答了几个问题。
  • 一个包含多选答案问题的触发表单，您应该在您的应用中发送响应时选择一个或多个选项，以检查所有值是否正确传递。
  • 启用 Zaps 并向每个表单提交新条目，以检查 Zap 是否触发并包含预期的响应。